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El QUE 10 
SABE 





D icen que empezar nuevos proyectos es fácil, la 
tarea difícil es mantenerlos; nos costo mucho 
sacrificio pero después de 10 años continuamos 
firmes en poder brindar un medio que permita compartir 
conocimientos y experiencias entre nuestros autores y 
lectores. 

Lo maravilloso es que siempre cada etapa se inicia con lo 
aprendido en la anterior, nosotros al igual que nuestros 
lectores aprendimos muchísimo durante todo este tiempo, 
pero lo más importante, supimos mantener nuestra 
esencia y nuestro compromiso. 

Enseñar es dejar una huella en las vidas de otras 
personas, en AtixLibre estamos seguros que cumplimos 
ese objetivo, ya que brindamos lo que se encontraba en 
nuestras manos para poder aportar a su saber y sobre 
todo a la ardua tarea de difundir conocimiento y cultura 
de forma libre, sin distinciones ni prejuicios. 

10 años atrás nos pusimos un lema "Atix hacia un 
futuro innovador, por un mundo ético, libre y justo", 

estoy seguro que con lo que realizamos hasta ahora, 
cumplimos a cabalidad lo propuesto; aunque tuvimos 
varios contratiempos, aun seguimos con el espíritu firme 
e intacto y con muchas ganas de continuar. 

En nuestra vida aprendimos que el conocimiento no es 
nada, sino lo compartes y lo difundes, ahora es grande la 
satisfacción de haber dado los pasos que dimos; pocos 
tal ves, lentos muy posible, pero de seguro lo hicimos con 
la mayor predisposición y enorme placer. 

Sean bienvenidos a nuestra edición número 23. 



Presidente Fundación AtixLibre 
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NodeJS 

JavaScript en el servidor 


Node.js es un entorno de ejecución para JavaScript en el lado del servidor. Se basa en el uso 
de operaciones asincronas para las operaciones de 1/0 (lectura/escritura) lo que evita bloqueos 
haciéndolo una elección a tomar en cuenta cuando se piensa en construir una aplicación de red 
escalable. 

Introducción 

Las operaciones de l/O 1 son pesadas (toma mucho tiempo realizarlas comparadas con otras 
operaciones), y en los lenguajes tradicionales esto implica utilizar un hilo para cada operación 
que se realiza. Node.js afronta este problema de otra manera ya que solamente cuenta con un 
hilo de ejecución, por lo cual “terciariza” dichos procesos al kernel del sistema operativo. 



Desarrollo 

La forma “tradicional” de realizar una operación en la mayoría de los lenguajes de programación 
es secuencial, por ejemplo, en una aplicación web se suele obtener información de una base de 
datos, esperamos a que la información nos sea devuelta para posteriormente tratarla y dar una 
respuesta al cliente. Este proceso se realiza secuencialmente y se espera a que cada línea de 
ejecución termine para continuar con la siguiente. 



TAREAIO; 

RESU LT AD0_TAREA_2 = TAREA2_PETICI0N_BASE_DE_DAT0S_0_RED(); 
TAREA3(RESULTAD0_TAREA_2); 

TAREA4(); 


El problema con esta forma de manejar las operaciones es que no todas las tareas tienen un 

1 l/O se refiere a la interacción de un programa con el exterior, como por ejemplo con los dispositivos 
de almacenamiento (disco duro u otro) ó la red (solicitud de información a otros sistemas). 





tiempo de respuesta corto; usualmente las operaciones que requieren l/O (en el ejemplo la 
lectura de la base de datos) toman un tiempo mayor que otras y nuestra aplicación (un hilo 
usualmente) se encuentra bloqueada hasta que la respuesta sea retornada. Esta forma de 
manejar las operaciones se denomina síncrona y se puede ver como se ejecutan las tareas una 
tras otra en el siguiente diagrama: 


Programación Síncrona 


TARE Al 

TAREA2 

Petición por la red 

Espera de la respuesta de la 
petición 

TAREA3 Hacer algo 
con la respuesta de 
la petición 

TAREA4 


1 > 

Ilustración 1: Programación síncrona 


Programación asincrona 

La programación asincrona es una forma de realizar operaciones de forma paralela donde una 
unidad de trabajo corre separadamente del hilo principal de ejecución. 

Node.js es single threaded (se ejecuta solamente sobre un hilo), por lo tanto, si tengo una 
aplicación web y esta se queda esperando a que una operación se realice, muchas otras 
peticiones no se podrían atender. 

Para solucionar este problema, se utiliza la programación asincrona, donde se evita bloquear el 
hilo principal de ejecución dejando las operaciones de 1/0 al kernel del sistema operativo 
siempre que sea posible. Por ejemplo, un diagrama de la ejecución del ejemplo 1 en node.js 
pero de manera asincrona sería: 



Programación Asincrona 


TARE Al 

TAREA2 

Petición por la red 

TAREA4 


TAREA3 Hacer algo 
con la respuesta de 
la petición 


Espera de la respuesta de la 
petición 



í> 


Ilustración 2: Programación asincrona 

Como se puede observar, la petición de la TAREA2 se realiza sin bloquear la ejecución de 
nuestro programa, una vez terminada la TAREA2 se puede continuar con la TAREA3. 

Algunos de los conceptos que debemos conocer para comprender realmente el funcionamiento 
de node.js son: 


Heap 

Los objetos y variables creadas se almacenan en un espacio de memoria denominado heap. 






















Cali stack 

El cali stack es la cola donde se almacenan de manera ordenada las funciones que se están 
ejecutando y/o que faltan ejecutarse. 

Cuando comenzamos a ejecutar una función, esta se inserta en el cali stack y cuando termina 
su ejecución (returns) se saca del cali stack. 

Muchas veces, cuando creamos un ciclo de llamadas a funciones que no tiene fin, este cali 
stack se llena y luego se desborda lo que provoca el clásico error denominado “stack overflow”. 

Los errores que la mayoría de los lenguajes imprimen vienen con una lista del cali stack, lo que 
permite saber en que función falló nuestro programa. 


Event loop 

El event loop permite a node.js realizar operaciones 1/0. Dado que el kernel es multi-threaded, 
se pueden ejecutar muchas operaciones en segundo plano, cuando una de las operaciones se 
completa, el kernel informa que la operación ha concluido y que se puede ejecutar la operación 
que le sigue. 


Son varias fases las que se ejecutan en el event loop, y cada fase cuenta con una cola de 
funciones que deben ejecutarse (callbacks). Cuando en la cola de una fase no existen más 
funciones para ejecutar entonces se pasa a la siguiente fase. 



Veamos un poco a detalle de que se realiza en cada fase: 

• Timers: en esta fase se ejecutan las funciones programadas con setlnterval y 
setTimeout. 

• Pending callbacks: en esta fase se ejecutan las funciones en las que intervienen 1/0 
y/o que fueron aplazadas en el último ciclo. Como la mayor parte del código que 
escribimos son callbacks, esta es la fase donde se ejecuta nuestro código. 

• Idle, prepare: fase utilizada internamente por node.js. 

• Poli: acá node.js se detiene para obtener nuevos mensajes de los eventos 1/0. Los 
eventos que han sido retornados por el kernel del sistema son ejecutado en esta fase. 



















• Check: En esta fase se ejecutan las funciones programadas por setlnmediate. 

• Cióse callbacks: En esta fase se emiten eventos cióse. Estos eventos son lanzados por 
ejemplo cuando un socket se ha cerrado abruptamente. 

A cada ciclo del event loop se le denomina tick. 

Dado que node.js es single threaded, en máquinas que tienen varios núcleos se debe utilizar el 
módulo cluster, lo que permite generar un proceso hijo (child process) por cada núcleo. Cada 
proceso hijo tiene su propio event loop y el proceso maestro (master process) 
transparentemente distribuye la carga entre los procesos hijos. También es posible utilizar otras 
herramientas como pm2 2 , phusion passenger 3 u otros. 

Si una tarea tarda demasiado en ejecutarse en el event loop, este se bloquea por lo cual no se 
ejecuta ninguna tarea adicional hasta que la tarea que se encuentra bloqueando el event loop 
finalice su ejecución. 

Pero, si node.js es single threaded, ¿a dónde van las tareas que se ejecutan asincronamente?. 

Las tareas asincronas se van a un worker pool y son implementadas por libuv 4 . 

Lo más importante si se quiere poder construir un servidor que responda a una gran cantidad de 
solicitudes al mismo tiempo es no bloquear el event loop. 

Node.js utiliza el motor v8 5 de google para ejecutar todo el código javascript que se encuentra 
optimizado para la mayoría de las operaciones, sin embargo, existen expresiones regulares y 
otras operaciones síncronas que pueden resultar desastrosas para la ejecución de cualquier 
programa (se deja de responder a solicitudes). 



Algunos módulos a tomar en cuenta para no bloquear 

Varios de los módulos del núcleo de node.js tienen operaciones síncronas que son bastante 
pesadas (bloquean el event loop) por lo cual deben utilizarse conociendo sus ventajas y 
desventajas. 

Las librerías de cifrado (crypto), del sistema de archivos (fs) y compresión (zlib), en general las 
funciones que no deben utilizarse suelen terminar con la palabra sync, por ejemplo 
readFileSync. 

Por ejemplo, una función síncrona puede utilizarse cuando el servidor de node.js está 
levantando pero debe evitarse su uso cuando se está respondiendo a solicitudes de los clientes. 


Ejemplos para comprender la naturaleza asincrona de 
node.js 

Ahora que ya conocemos un poco del núcleo de node y varios conceptos, veamos algunos 
ejemplos para comprender mejor como se ejecutan las solicitudes realmente y conocer algunas 
funciones básicas del lenguaje. 

Ejempo 1: realizamos la impresión de “uno”, “dos” y “tres”. 

- consoie.log permite imprimir a stdout con un salto de línea. 

consolé.log('uno'); 
consolé.log('dos'); 
consolé.log('tres'); 


2 https://github.com/Unitech/pm2 

3 https://github.com/phusion/passenger 




Cuando este código sea ejecutado se imprimirá en la consola: 


uno 

dos 

tres 


Nada nuevo o diferente comparado con otro lenguaje, las operaciones se ejecutan una tras otra 
sin problemas. 


Ejemplo 2: realizamos la impresión de “uno”, “dos” y “tres”, pero esperando un segundo 
(lOOOms) para la impresión de “dos”. 

setTimeout: permite ejecutar una función después de determinado tiempo. (Debe recordarse 
que los timers son asincronos) 


consolé.log('uno'); 


setTimeout(fuñetion 

0 { 

consolé.log(' 

dos'); 

}, 1000); 


consolé.log('tres') 

r 


Cuando este código sea ejecutado se imprimirá en la consola: 

uno 

tres 

dos 



La explicación es simple, se ejecuta el primer consoie.log (uno), luego se programa una 
función para ejecutarse en un segundo, entonces se imprime el tercer consoie.log (tres); por 
último luego de un segundo de espera se ejecuta la función que tiene el segundo consoie.log 
(dos). 

Ejemplo 3: realizamos la impresión de uno, dos y tres, y establecemos una función que se 
ejecute después de cero segundos. 


consolé.log('uno'); 
setTimeout(function () { 
consolé.log('dos'); 

}, 0 ); 

consolé.log('tres'); 


Ahora sin embargo suceden algunas cosas interesantes, veamos la respuesta que el programa 
devuelve: 


uno 

tres 

dos 


Pero, ¿porqué “dos” se imprimió al final si el tiempo de espera era 0 segundos? 

Esto es debido a lo que se explicó previamente del event loop y se debe a que las funciones 
asincronas se ejecutan en un worker. Veamos las partes involucradas: 


4 http://d 0 cs.libuv. 0 rg/en/vl.x/threadp 00 l.html 

5 https://developers.google.com/v8/ 
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■Hilo Principal- 


í> 



Pasos que realiza el motor de node.js: 

1. Ejecuta consolé.log('uno') 

2. Envía la función setTimeout al worker de timers. 

3. Ejecuta consolé.log('tres') 

4. Como todavía quedan funciones que deben ejecutarse en el cali stack, se obtiene el 
resultado del timer que ya se ha ejecutado y se ejecuta la función que imprime 

consolé.log('dos'). 

5. El programa finaliza porque no quedan operaciones pendientes. 





Como se indicó previamente, la función con el timer se ejecuta en el siguiente tick, por lo cual 
pese a que tiene un tiempo de cero se ejecutará al final. 


Conclusiones 

• Node.js es un lenguaje de programación con el cual podemos ejecutar javascript en el 
servidor y es ejecutado por el motor v8 de chrome, y las tareas asincronas son 
ejecutadas por libuv 6 . 

• En un principio es complicado comprender como funciona internamente node.js y 
especialmente la programación asincrona, pero una vez que se entiende los procesos 
internos, es muy sencillo programar con node.js. 

• El problema de adopción de node-js, es cultural , ya que a todos nos enseñan como 
realizar las operaciones una tras otra y pasar a un estilo de programación asincrona 
suele presentar dificultades e incluso miedo en un principio. 

• Si bien node.js permite realizar un procesamiento eficiente de los procesos que 
involucran l/O, no es un remedio para todo tipo de problema, siempre debe utilizarse la 
herramienta (o lenguaje) que permita resolver los problemas de manera más sencilla y 
eficiente. Es importante que los procesos que necesitan hacer uso alto del procesador 
(CPU) sean trasladados a un worker externo para que no bloqueen el hilo principal de 
node.js, o incluso, posiblemente que sean implementados en otro lenguaje. 

El siguiente artículo introducirá el uso de promesas y varias funciones útiles de node.js. 


6 http://libuv.org/ 
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UferePlan 

Gestión de Proyectos 


El éxito final de un proyecto está en la adecuada gestión de sus variables, como ser recursos, 
tiempo, costos, etc. Las herramientas más utilizadas para la gestión de proyectos son EDT, 
Diagrama Cantt, Costos, entre otros; pero lo más relevante no es es el poder gestionar un solo 
proyecto a la vez, sino todo un Portafolio de Proyectos. LIBRE PLAN en un software que nos 
ayuda en la gestión de Proyectos individuales y en la gestión de un Portafolio de Proyectos. 


Introducción 

Para la correcta gestión de proyectos es necesario tener una vista rápida de la EDT (Estructura 
de Descomposición/Desglose de Trabajo) y su respectivo Diagrama Gantt, con las 
consideraciones necesarias respecto a recursos, tiempo y costos asociados. Adicionalmente, es 
necesario también una vista rápida del Portafolio de Proyectos que nos permite tener de forma 
óptima y oportuna el control de los proyectos que conforman el portafolio y de los recursos que 
normalmente son los mismos en su mayoría para los proyectos que conforman el portafolio. 


LIBREPLAN 

OpenWebPLa.nni'ng 



i 



Características 

Entre las características de LIBREPLAN están: 

• Multiproyecto, permite la gestión de un Portafolio de Proyectos. 

• Gestión de recursos. 

• Planificación, a través de EDT, plantillas, reasignación de recursos automática, etc. 

• Asignación avanzada de tareas. 

• Simulación Monte Cario, para la estimación de fechas de conclusión de proyectos. 

• Control y seguimiento de proyectos. 

• Subcontrataciones y gestión de materiales por tarea. 

• Colaborativo, ya que es una plataforma web la cual permite la interacción de todos los 
gestores del o los proyectos y puede también integrarse con autenticación LDAP. 


Herramientas 




Instalación 

Para la versión LIBREPLAN vi.4 es necesario como prerrequisito la instalación del Web Server 
TOMCAT v6. 

LIBREPLAN vi. 4 se lo puede bajar de https://sourceforge.net/projects/libreplan/ 
(paquetes en formato DEB). 

Para la instalación se puede utilizar los diferentes métodos y/o programas de gestión de 
paquetes, en este caso utilizamos Gdebi: 

Instalador de paquetes - LibrepLan x 


Archivo Editar Ayuda 

Paquete: LibrepLan Instalar paquete 

Estado: Requiere DetaLLes 

La 

instalación 
de 13 
paquetes 


Descripción 

Detalles 

Archivos incluidos 

Salida de Lintian 



Web application for project planning, monitoring and control. 

LibrePLan is a coLLaborative tooL to plan, monitor and controL projects and has a rich 
web interface which provides a desktop aLike user experience, ALL the team 
members can take part in the pLanning and this makes possibLe to have a reaL-time 
pLanning, 



En el proceso de instalación se creará la clave de administración de la base de datos y 
aplicación: 


Debconf en Flia2 


x 



Después de la instalación, se puede ingresar con un Web Browser a: 

http://127.0.0.1:8080/libreplan/conunon/layout/login.zul 


erramientas 



















C |Q, Buscar 


LIBREPLAN 

OpenW»b?l4nntng 


Access to the system Help 

User 

admin 

Password 


1 L °g ¡n I 




0 


[ÉJS--I ñ 


1 XUNTA 
DE GALICIA 


La documentación o manual de usuario, se habilita con la instalación de la aplicación en el 
mismo Web Server y se encuentra en: 


http://127.0.0.1:8080/libreplan/help/en/index.html 




LibrePlan: User documentation 


libr: plan -' 


Following document corrtains necessary help for using LibrePlan, the opensource web application for project planning. 
This document is divided in three main sections: 


First, global goals and behaviour. 

Second, basic entitiesto understand the minimum conceptsto use LibrePlan. 

Finally, complete processes description to create orders, projects, project planning. resources assignment, advance assignment and result extraction. 

1. Introduction 

2. Criteria 

3. Calendars 

4. Proaress 

5. Management of resources 

6. Orders and order elements 

7. Task planning 

8. Assignment of resources 

9. Work reports 

10. Tags 

11. Materials 

12. Qualitv forms 

13. Users 

14. Cost management 

15. Reports 

16. LDAP C onfiauration 

17. Project dashboard 

18. Connectors 

19. Scheduler 

20. About 


Ejemplo 

A continuación, explicamos en un ejemplo la creación de dos proyectos y sus recursos 
asociados. 

1) Primero creamos un proyecto llamado “Proyecto ALPHA": 


erramientas 






































127.0.0.1:8080/libreplan/planner/index.zul;company_schedul¡ng 

LIBREPLAN - 


C lo. Buscar 


*? m 


Resources Cost Configuration Communications Reports Personal area 


user: admin [Log out] 


START » Planning » Projects Planning 


Help (f) (!) 



Resources Load 


■ Zoom: Week w Fiher 

Ñame Start End 


enero ,2017 


M ay 1,2018 |(jl)| to | May 31, 2018 |(jt) subelements M 

febrero ,2017 


marzo,2017 abril,2i 

• I ■ - » I - I - I « I - 


127,0.0.1:8080/Librep[an/planner/index.zuL;company scheduL¡ng C |Q> Buscad 

PLAN 


Configuration Communications Reports Personal a 


from May 1.2018 TT to l.lay 31, 2018 TT subelements l_l 

marzo ,2017 



Ñame 

Proyecto Alpha 

Témplate 

na 

Code 

erommm.'* 

Starting date 

May 1.2018 

Deadline 

Jun 30. 2018| [ff 

Customer 


Calendar 

Default ü 

O Accept O Cancel 


ip©0 


Resources Load 


Queue-based 

Resources 

Planning 


2) A continuación, creamos tres tareas: 


127.0.0.1:8080/libreplan/planner/index.zul;company_scheduling 

LIBREPLAN — 


C |Q, Buscar 


Resources Cost Configuration Communications Reports Personal area 


user: admin [Log out] 


START > Planning > Projects List 


Help ® ® 


Fiher j 


H3 fr ° m l 


~1Ü1 to C 


|(fl) subelements Q ^ 


Planning 

[mi 


| Provecto Alpha | 


Ñame 

Code Starting date 

Deadline 

) 

ORDER0005 l.lav 1. 2018 

Jun 30. 2018 


Iget Hours State Operations 

0€ 0 PRE-SALES 


erramientas 
















































































C |Qv Buscar 


Configuration Communications Reports Personal area 


user: admin [Log out] 


START » Planning » Project Details » Proyecto Alpha 
with | 


Help ® (|) 


options ▼ 

WBS (tasks) | General data | Cost | Progress | Labels | Criterion Requirement [ Materials | Task quality forms | Authorizations 


I New task 


Hours 0 Add |1 Add From Témplate 

Selected node: / ^ ^ j^| 

Scheduling State 

Code 

Ñame 

Hours Budget Ivluststart after Deadline Op. 




Editamos la tarea creada para agregar el costo y fechas: 



LIBREPLAN — ' 


START » Planning » Project Details » Proyecto Alpha 


u o 


^ options ▼ 




New task | 


1_1_1_1:1- 

Hours 0 Add Add From Témplate 

- 1 :: 1 _l 

Selected node: u. ^ 14 ^1 9 

Scheduling State 

Code 

Ñame 

Hours Budget 

Muststart after Deadline Op. 



Tarea A-l 

40 0< 

.•. i"" . B£. 


san 


Details | Cost | Progress | Labels | Criterion Requirement | Materials | Task quality forms 
Task ñame Tarea A-l 

Code 

Starting date | May 1,2018 |1f 

Deadline 


|May 8. 2018 |g| 


Agregamos dos tareas adicionales de ejemplo: 



LIBREPLAN^* r 

fcj «> Task 


Resources Cost Configuration Communications Reports Personal area 


START » Planning » Project Details » Proyecto Alpha 

J with | |/3) options 


Filter ' ! 


user: admin [Log out] 

Help ® ® 


WBS (tasks) | General data | Cost | Progress | Labels | Criterion Requirement | Materials | Task quality forms | Authorizations | 


New task 

1 j ----- 1 - | —., 

Hours 0 Add Add From Témplate 

1 - | 


Selected node: £ - j + 4- |+ +| íf 

Scheduling State Code 

Ñame 

Hours 

Budget 

Must start after Deadline Op. 


Tarea A-l 

k° 

0< 

/9 


Tarea A-2 

120 

0< 

h 9 


Tarea A-3 

i 120 

0 € 

b 9 



Herramientas 







































































































3) Ahora, creamos dos recursos llamados “Ana Paz” y “Juan Perez”: 




WBS (tasks) General da 
w task 


Scheduling State 




Machines 
Virtual Workers 
Calendars 
Calendar Exceptic 
Críteria 

Progress Types 
L abéis 
Materials 
Material Units 
Quality Forms 


| Criterion Requirement | Materials | Task quality forms | Authorizations j 


Id From Témplate 



Selected node: 4 4 4 * 4 1 


Hours 

Budget 

Must start after Deadline 

Op. 


140 

01 




120 

0 € 


41 


120 

0 € 


41 



127.0.0.1:8080/libreplan/resources/worker/worker.zul#create 

LIBREPLAN - 


e lo, Buscar 


Planning 


Cost Configuration Communications Reports Personal atea 


START * Resources ► Workers 


user: admin [Log out] 


Help (?) (í) 


► Workers List 




Filter by 


pL) Personal details 

More options Filter 

Súmame 

“ First ñame 


ID 

Code 

Queue-based Operations 

Paz 

Ana 


002 

WORKER0002 

no 

Perez 

Juan 


001 

WORKER0001 

no 


O Create 


4) Asignamos los recursos a las tareas: 


LIBRSPLAN 

W tí 




C lo, Buscar 


Resources Cost Configuration Communications Reports Personal atea 


user: admin [Log out] 


START » Planning » Project Scheduling » Proyecto Alpha (pre-sales) 

y v R| 0 m z °° m: ^ Task 

m Mame Start End 


Help (?) ® 


Tarea. A-l 
Tarea A.2 
TareaA-3 


.1. m fíranhins 


abrí 1,2018 


options ▼ Filter ^ 

junio ,2018 


5,118 

5,711 

5 , 28,18 


5/718 

5,2818 

6,1818 


□ 


Ce 


"Ce 


Herramientas 




























































































127.0.0.1:8080/libreplan/planner/index.zul;order=ORDER0005 

LIBREPLAN — ' 

Oc»-w*fc?i«nfiirg START » Planning » Project Scheduling » Proyecto Alpha | | re sales | 

fej f3 H Zoom: Week v " ^1 4» ? ? T ^ ^ Task 

abrí 1,2018 



] with | 



Add Dependency 


^ Add Milestone 


/, Task Properties 


— Resource allocation 


Advanced allocation 


Subcontract 


0 Calendar allocation 


Help (|) ® 


▼ Filter ‘ 


Task Information 


Criteria 

Type 

Hours 


WORKER 

40 


Total estimated hours: 

40 

Recommended allocation 


Allocations 

Select criteria or resources 


Apply tab changes 


O Accept O Cancel 


Allocation configuration 

Planned slart: 5/1/18 Planned end: 5/7/18 
Planned workable days: 5 

* Calcúlate Workable Days 
Calcúlate Number of Hours 
Calcúlate Resources per Day 


yJ ¡_Add Advanced search") | Extended v 



Ñame 

Hours F 

Non Consolidated 

Paz.Ana (002) 


|40 

Total 


|10 


Resources Per Da; Op. 
Non Consolidated 
11.0000 ] 

11.0000 


i H 


Repetimos la asignación de recursos a todas las tareas. 

5) Para tener un ejemplo de portafolio de proyectos creamos un segundo proyecto llamado 
“Proyecto BETA” con dos Tareas y les asignamos los recursos ya creados “Ana Paz" y “Juan 
Perez”: 


e |Q. Buscar 


127.0.0.1:8080/Libreplan/planner/index,zul;orders_list 

l'.R' p| M Resources Cost Configuration Communications Reports Personal area 

tí v 


: admin [Log out] 


START » Planning » Project Scheduling »^Pt^yect^^nAj ^pre-sales ) 

R 0 ^ Zoom: Week v ™ 4 1 ^ ? r ^ ^ TaskQ 

M ” le- mayo,2018 


Help ® (í) 


with | 


is ▼ Filter " 
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6) Ahora podemos ver los Recursos versus las Tareas de todos los proyectos: 

m nH 


127.0.0.1:8080/L¡breplan/pLanner/index,zul;company_scheduLing 

LIBREPLAN - 


1 ^i 

Q. Buscar 


Resources Cost Configuration Communications Reports Personal atea 


user: admin [Log out] 


START » Planning » Resources Load 

jjJ Zoom: Week v From: May 2.2018 "7 To: 


Help (f) © 




m 


Ñame 
Pu, Ana 

Proyecto Alpha 
Tarea A-l 
Tarea A.2 
Proyecto BETA 
Tarea B-l 

Projects List Perez.Juan 

Proyecto Alpha 

_ -.Tareas 

I “ ■ Tarea A.3 

Proyecto BETA 
Tarea B-ll 


Page: |P • P | w | Group by: | Resources v Resources or arteria: | 

mayo ,2018 junio ,2018 julio ,2018 agosto ,2018 



En esta vista podemos ajustar los recursos en cuanto a tiempo, en caso de que se tenga 
sobrecarga, etc. y podremos ver de forma automática la reasignación de recursos. 


7) Podemos ver también los Dashboards de cada Proyecto: 

I 13 R'' PLAN I | Resources Cost Configuration Communications Reports Personal area 

y * 



admin [Log out] 


START » Planning » Dashboard » Proyecto Alpha 


Project progress percentage 


Spreading progress 
By all tasks hours 
By critica! path hours 
By critical path duration 


Resources Loiui 


Progress percentage per progress type 


Current State indicators 


I Current 
[ Expected 



I Finished (O tasks) 
j] In progress (0 tasks) 

I] Ready to start(l tasks) 
I Blocked (2 tasks) 


Projectclosing previsions 


CV (Cost \fetiance) 

CPI (Cost Performance Index) 

Oh 

0 .00% 

ACWP (Actual Cost Work 

ETC (Estímate To Complete) 

Performed) 

Oh 

Oh 



Help (j) (|) 


EAC (Estímate At Completion) 

VAC (\fcriance At Completion) 

Oh 

280 h 

BAC (Budget At Completion) 

280 h 



Estimation deviation on completed tasks 


Resources usage 



Overtime ratio Availability ratio 

o% y 3% 
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127.0.0.1 : .080/L¡breplan/pLanner/index.zuL;orders_list 

LIBREPLAN 

Oo*- 

y * 


C IQ. Buscar 


Resources Cost Configuration Communications Reports Personal area 


user: admin [Log out] 


START » Planning > Dashboard » Proyecto BETA 


Spreading progress 
By all tasks hours 
By critica! path hours 
By criticad path duration 


Progress percentage per progress type 


Current State indicators 


CV (Cost \feriance) 

CPI (Cost Performance Index) 

Oh 

0.00% 

ACWP (Actual Cost Work 

ETC (Estímate To Complete) 

Performed) 

Oh 

Oh 



Project progress percentage 


Task Status 



cqq¿ |H Finished (0 tasks) 


IM Current 

■ In progress (0 tasks) 


H1 Expected 

■ Ready to start(l tasks) 



|Bf; Blocked (1 tasks) 


Project closing previsions 


EAC (Estímate At Completion) 

VAC (Nferiance At Completion) 

Oh 

200 h 

BAC (Budget At Completion) 

200 h 



Help ® ® 


Estimation deviation on completed tasks 


Resources usage 


Overtime ratio 

o% y 


Availability ratio 

0 % 



8) Por último podemos crear usuarios de acceso al LIBREPLAN con diferentes roles y perfiles, 
según la necesidad de cada proyecto y/o el Portafolio de Proyectos: 



C |Q. Buscar 


LIBRLPLAN 

.■•-t 

» Users List 


Communications Reports Personal area 


START * Configuration ► User Accc 


| o Create 


Main Settings 
User Accounts 
Profiles 


user: admin [Log out] 


Help ® ® 


Username 

Disabled 

Job Scheduling 

Authentication type 

Bound resource 

Actions 

admin 

No 

Yes 

Dat abase 


h 

hresources 

No 

No 

Dat abase 


¿a 

manager 

Yes 

No 

Dat abase 


a a 

outsourcing 

Yes 

No 

Dat abase 


a a 

reports 

Yes 

No 

Dat abase 


a a 

wsreader 

Yes 

No 

Dat abase 


a a 

wssubcontracting 

Yes 

No 

Dat abase 


a a 

wswriter 

Yes 

No 

Dat abase 


a a 


Conclusiones 

• Este tipo de herramienta nos facilita la Gestión de Proyectos y el control del Portafolio de 
Proyectos. Los reportes generados nos brindan información muy importante y detallada 
para la administración de recursos de forma oportuna. 


erramientas 


































• Al ser una aplicación con la información centralizada en un Servidor Web, la 
actualización del avance de tareas, demoras, nuevas tareas, etc. pueden ser realizadas 
por los usuarios pertenecientes a cada proyecto de forma independiente y como 
resultado tener los Dashboards actualizados de forma inmediata. Estos indicadores o 
Dashboards nos ayudan a la toma de decisiones oportuna y así poder alinear la 
ejecución de los proyectos según la estrategia propuesta. 



Referencias 

[1] http://www.libreplan.org/ 
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Ansible 

Aprovisionamiento de Software 


En un mundo donde la existencia de arquitecturas variables, contextos heterogéneos y una 
gran cantidad de nodos por gestionar, la tarea de administrar se ha convertido en una tarea 
tediosa y muchas veces repetitiva, por lo que surge la necesidad de contar con herramientas e 
instrumentos que permitan a los SysAdmin y Developers automatizar estos procesos de forma 
sencilla, entendible y segura, independientemente si se encuentran en arquitecturas de nodos 
físicos, virtuales o en la nube. 

Ansible es una plataforma de software libre para configurar y administrar ordenadores y/o 
servidores. 


Que es ansible 

Ansible es una herramienta que nos permite gestionar configuraciones, aprovisionamiento de 
recursos, orquestación, despliegue automático de aplicaciones y muchas otras tareas de TI de 
una forma limpia, sencilla y segura. 


jme: disable the . 
Shell: echo "disable 
delegate_to: "{{ item 
with_items: groups.tag. 

roles: 

- common 

- base-apache 

- web 


■<st_tasks: 

'"ie: Enable the - 




A 
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Ansible permite 

• Instalaciones multi-nodo 

• Ejecuciones de tareas ad hoc 

• Administración de configuraciones 

• Manejar nodos a través de SSH 

Para todo esto y mucho más, no requiere ningún software remoto adicional (excepto Python 2.4 
o posterior). 
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Características 

• Minimalista: Es una sistema de administración que no impone dependencias 
adicionales. 

• Consistente: Es muy robusto y fuerte en su funcionalidad 

• Seguro: Ansible no instala agentes vulnerables en los nodos. Solamente se requiere 
OpenSSH que es considerado crítico y altamente testeado. 

• Alta confiabilidad: El modelo de idempotencia es aplicado para las instalaciones y 
configuraciones, para prevenir efectos secundarios en la ejecución repetitiva de Scripts. 

• Curva de aprendizaje mínima: ya que hace uso de de los playbooks, los cuales usan 
un lenguaje descriptivo simple, basado en YAML. 


Integración con diferentes arquitecturas 


Independientemente de la arquitectura que disponga nuestra infraestructura, Ansible puede 
instalarse en ambientes físicos, virtualizados, nubes públicas y privadas: también puede 
instalarse en entornos para analizar y archivar big data. 



var files playbooks 


«lüamazon 

10 web Services 




docker 





¿En qué se diferencia de otras herramientas similares? 

• No necesita agentes 

• No requiere de configuraciones engorrosas y complicadas 

• Flexibilidad (API, Módulos, Plugins) 

• Facilidad de uso 

















Componentes 

• Máquina de Administración: es la máquina donde tenemos instalado Ansióle, y desde 
donde podremos ejecutar las tareas y/o gestionar los nodos. 

• Inventario: es una descripción de los nodos que pueden ser accedidos por Ansióle 
(maquina de administración). El inventario está descrito por un archivo de configuración, 
en formato INI, cuya uóicación por defecto es /etc/ansibie/hosts. En el archivo de 
configuración se listan las direcciones IP o hostname de cada nodo que es accesible por 
Ansióle. Además, los nodos pueden ser asignados a grupos. 

• Playbook: describen configuraciones, despliegue, y orquestación; el formato del 
Playbook es YAML. Cada Playbook asocia un grupo de hosts a un conjunto de roles, 
cada rol está representado por llamadas a lo que Ansióle define como Tareas. En 
resumen un PlayBook lista las tareas que deben ejecutarse en los diferentes nodos. 

• Tarea: son bloques dentro del Playbook donde se define una acción específica a realizar 
(instalar paquetes, ejecutar Scripts, verificar estado de actualizaciones, etc). 

• Modulo: son las unidades de trabajo en Ansióle; cada módulo es auto-suficiente y puede 
ser escrito en lenguaje estándar de scripting, como ser Python, Perl, Ruby, Bash, etc. 
Una de las propiedades principales de los módulos es la idempotencia la cual asegura 
que ninguna operación se realizará una vez que el sistema ha alcanzado el estado 
deseado. 

• Roles: permiten ordenar los diferentes Playbooks. 

• Facts: variables dentro de Ansióle que contienen información sobre los servidores 
(Sistema Operativo, Cantidad de Ram, Direcciones IP, etc) 

• Handlers: código que se usa cuando algo cambia o existen excepciones (si actualizas 
el archivo de configuración de Apache, un Handler re-iniciará el servicio httpd). 

Como funciona Ansible 

• Ansióle no precisa instalar ni Agentes, solo un equipo a partir del cual se realizará la 
gestión de los diferentes nodos. 

• Ansible se conecta a los nodos que se desea gestionar, aprovisionar u orquestar 
utilizando una conexión SSH, mediante la cual le envía una serie de instrucciones a 
ejecutar y/o configuraciones que se desee aplicar. 

¿Quiénes usan Ansible actualmente? 

Por su simplicidad Ansible es utilizado por muchísimas empresas. Entre ellas: 

• Atlassian 

• NASA 

• Evernote 

• Spotify 

• Verisign 

• RedHat 

• Amazon 
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Instalación 

• RedHat y CentOS: yum instan ansible 

• Debían: apt-get install ansible 

Pasos para realizar la gestión de nodos 

• Conectar el equipo de administración con los nodos 

• Configurar el inventario de nodos 

• Realizar pruebas de conectividad 

• Realizar la gestión y/o aprovisionamiento 

Conectar el equipo de administración con los nodos 
Generar la llave 

Generar la llave en el nodo administrador 
ssh-keygen 



Esto genera 

-/.ssh/id_rsa 
~/.ssh/id_rsa.pub 


Copiar la llave pública 

Copiar la llave del nodo administrador a los nodos a administrar 

ssh-copy-id -i -/.ssh/id_rsa.pub root@web01.atixlibre.org 
ssh-copy-id -i ~/.ssh/id_rsa.pub root@web01.atixlibre.org 
ssh-copy-id -i ~/.ssh/id_rsa.pub root@web01.atixlibre.org 


Archivos de configuración 

/etc/ansible/ 


Configurar el inventario de nodos 

/etc/ansible/hosts 


[servidoresweb] 
web01.atixlibre.org 
web02.atixlibre.org 
web03.atixlibre.org 
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[basesdedatos] 
db01.atixlibre.org 
db02.atixlibre.org 
db03.atixlibre.org 


Realizar pruebas de conectividad 



Ejecución ad hoc 

ansible all -m ping -u root 


Resultado 


192.168.101.104 | success » { 
"changed": false, 

"ping": "pong" 


Ejecución sin -u root 


192.168.100.10 | FAILED => SSH encountered an unknown error during the connection. We 
recommend you re-run the command using -vvvv, which will enable SSH debugging output to 
help diagnose the issue 


Ejecución desde un playbook 

playbook_test.yml 

- hosts: servidoresweb 
remote_user: root 

tasks: 

- ñame: test de conexión 
ping: 


ansible-playbook playbook_test.yml 


Partes de una tarea 

Ñame: Cada tarea tiene un nombre, que sirve para identificar la tarea y también para el 
seguimiento de la misma. 


Ejemplo 

tasks: 

- ñame: Verificar si apache esta correindo 
Service: name=httpd state=running 


notify: son las acciones que se ejecutarán al final de cada tarea en el Playbook. Sólo serán 
ejecutadas una vez, incluso cuando sean llamadas por diferentes tareas. Por ejemplo: Muchas 
tareas pueden solicitar el reinicio de algún servicio específico, pero este sólo será reiniciado una 
sola vez. 
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Ejemplo 


notify: 

restart apache 



Ejecución 


ansible-playbook playbook.yml 

Ejemplo de playbook 

Crear un Playbook llamado webserver.yml, con el que vamos a instalar las herramientas 
necesarias para publicar una página web en varios servidores. 

####################################### 

# Hosts donde se realizarán las tareas 
####################################### 

- hosts: servidoresweb 
user: root 

##################################### 

# Instalación de paquetes necesarios. 

##################################### 

tasks: 

- ñame: General | Instalación de paquetes requeridos. 

action: apt pkg={{ item }} state=installed with_items: 

- php5 

- apache2 

- mysql-server 

- mysql-client 

- php5-mysql 

- php-apc 

- php5-xmlrpc 

- php-soap 

- php5-gd 

- unzip 

- python-mysqldb 

########################### 

# Configuración de Apache2. 

########################### 

- ñame: Apache2 | Habilitar módulos 

action: command a2enmod rewrite vhost_alias 

####################### 

# Reinicio de servicios 
####################### 


ñame: Reiniciar Apache 

action: Service name=apache2 state=restarted 
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Ejecución del playbook 

ansible-playbook Webserver.yml 


PLAY [Webserver] 


************************************************************** 


GATHERING FACTS *************************************************************** 

ok: [192.168.101.104] 


************************ 


TASK: [General | Instalación de paquetes requeridos.] 
changed: [192.168.101.104] => (item=php5,apache2,mysql- server,mysql-Client,php5- 
mysql,php-apc,php5-xmlrpc,php-soap,php5-gd,unzip,python-mysqldb) 


TASK: [Apache2 | Habilitar módulos] 
changed: [192.168.101.104] 


******************************************* 


TASK: [Restart Apache] 
changed: [192.168.101.104] 


******************************************************** 


PLAY RECAP 
192.168.101.104 


******************************************************************** 


: ok=4 changed=3 unreachable=0 failed=0 


Referencias 



[1] http://ww.ansible.com 
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Este artículo habla sobre la reestructuración de una aplicación web Rest utilizando el patrón 
Modelo Vista Controlador (MVC) con conceptos de Diseño Orientado al Dominio (DDD o 
Domain Driven Design) aislando cada parte del sistema en base a las reglas de negocio que 
definen su dominio y así hacerlo mas entendible, acoplable y mantenible. 


Introducción 

Para la implementación del servicio utilizaremos las siguientes tecnologías: 

• NodeJS, como entorno de ejecución para nuestra aplicación 

• Patrón MVC (Modelo-Vista-Controlador) como el patrón principal para la estructura 
inicial de la aplicación 

• REST (Transferencia de estado representacional) como estilo de arquitectura del 
sistema 

• DDD (Diseño orientado al dominio) como el enfoque que se propone utilizar para 
estructurar de mejor manera la aplicación. 


Desarrollo 

La aplicación que se desarrollará será la de un blog, con artículos, etiquetas y comentarios bajo 
el siguiente esquema: 



El código se encuentra disponible en github en el siguiente enlace: 
https://github.com/nardhar/nodejs-ddd, y se tendrán tags para cada uno de los pasos de 
este artículo 

Estructura Básica de aplicación REST con Express y Sequelize con el Patrón MVC (1 pagina) 
Primero creamos nuestra aplicación MVC siguiendo el ejemplo indicado por Sequelize (enlace) 






















pero cambiando la estructura de las carpetas para aplicar el modelo MVC de la siguiente 
manera: 

▼ 2 controladores 

(¡p) articulo.controlador.js 
jp comentan o.con Ero lado r.js 
|jp eti q ueta.con tro lado r.js 

▼ Q modelos 

|jp articulóos 
|P comen tari ojs 
(jp etiqueta js 
► H nodejnodules 
Í-- index.js 

15 package-lockjson 
5 package.json 


En index. js se describe la lectura de los archivos de los modelos y controladores 

Los archivos de la carpeta modelos son los típicos archivos de definición de Modelo de 
Sequelize 

En la carpeta controladores tenemos toda la lógica de guardado de artículos en conjunto con 
sus etiquetas, así como el guardado de comentarios, como ejemplo veremos la estructura del 
archivo controladores /articulo. controlador. j s 

1 module, exports = (router, models) => { 

router. get( '/articulo 1 , (req, res, next) => { 
return models.Articulo . findAndCountAll í) 

.thení (artículos} => { 
return res . status ( 2GQ ). j son [a rticulos); 

» 

.catch (next); 

}); 

router. postí /artículo 1 , (req, res, next) => { 
return models. Articulo, createtreq .body) 

.then( (articulo) => { 
if (articulo) { 

return res.status (2G1) . json (articulo}; 

> 

return res . status ( 4©0 ). json ({}); 

}) 

.catch (next); 

>>; 

21 // métodos get/:id, put y delete acortados para facilitar lectura 

22 > router. get( 1 /articulo/:id 1 , (req, res, next) => {-» 

router. put ( 1 /articulo/:id 1 , (req, res, next) => {- 

5G > router. deleteí 1 /articulo/:id 1 , (req, res, next) => {■=■ 

66 }; 

67 


El código de la aplicación se encuentra en el tag vo. i-iniciai 




Observaciones 

• Si queremos modificar el método de creación de articulo (e.g.: para agregar 
validaciones), debemos cambiar el código del controlador, debiendo verificar que no se 
altere el código correspondiente a la respuesta que se envía al cliente. 

• En caso de que se quiera agregar una funcionalidad para guardar artículos con etiquetas 
opcionales, se debe combinar parte de la lógica creada en articulo.controlador, js 
y etiqueta.controlador. js en Otro archivo O hacer que articulo.controlador, js 
se comporte condicionalmente de acuerdo a los parámetros enviados, lo cual ya suena 
algo complicado. ¿Y si quisiéramos incluir un método que permita guardar artículos, 
etiquetas y comentarios en conjunto? (más complicado aún). 

• El esquema actual no nos permita cambiar fácilmente el modo de almacenamiento, 
dependemos demasiado del ORM Sequelize, es decir que si necesitáramos cambiar a 
otro tipo de almacenamiento (mongoDB), debemos modificar todos los controladores, 
arriesgándonos a modificar la lógica del negocio. 

• No existe una capa que se pueda definir como el corazón del negocio del sistema, aquel 
archivo o archivos que permitan identificar como crear un articulo y sus relaciones. 
Aunque podría decirse que los controladores asumen ese rol, pero también cumplen 
otras funciones como la de recopilar los parámetros de la petición y también de darle 
formato a la respuesta para cumplir con el estilo de arquitectura REST, por lo que son 
algo más que el corazón del negocio del sistema (demasiada responsabilidad). 





Reestructuración de la aplicación con Diseño Orientado al 
Dominio 

El Diseño Orientado al Dominio es una forma de desarrollar software estableciendo como 
principal objetivo el desarrollo de la lógica del dominio que vendría a ser el corazón del sistema. 

Los artefactos que deben construirse son los siguientes: 

• Entidad, un objeto que esta definido por una identidad en vez de los atributos que lo 
definen. 

• Objeto Valor, un objeto que no tiene una identidad y esta definido por los atributos que 
lo componen. 

• Fábrica, métodos para la creación de objetos que permiten ser fácilmente cambiables 
por otros dependiendo de la necesidad de la lógica del negocio. 

• Agregados, cuando una colección de objetos corresponden a una entidad raíz que los 
controla, esta es un agregado. 

• Servicios, cuando una operación no corresponde conceptualmente a ningún objeto se 
debe crear un método utilitario para implementarla y así resolver el problema. 

• Repositorios, métodos para obtener objetos de un repositorio especial de forma que se 
pueda alterna entre implementaciones del almacenamiento. 

• Eventos de Dominio, un objeto que define un evento que ocurre dentro del alcance del 
sistema. 

¿Y como aplicamos estos patrones en nuestra aplicación?, primeramente vemos que Entidad y 
Objeto Valor en realidad se aplican con la capa del modelo (solo en el caso de nuestra 
aplicación), pero el resto de capas los aplica en su totalidad el controlador, por lo que se debe 
dividir sus responsabilidades en al menos una capa mas, la cual denominaremos servicio para 





mayor comodidad (no confundir con el patrón Servicio de DDD), modificando nuestra aplicación 
de la siguiente manera: 

▼ B controladores 

Jfjj articulo.controladür.js 
5 co m e n ta rio.con tro lado r.js 
|j_^ etiqueta.contralador.js 

▼ Q modelos 

i 5 articulóos 
(P comentario.js 
i 5 etiqueta.js 
► El node_modules 

▼ Qsemdos| 

i¡> articulo.serviciü.js 
(P comentano.serviciojs 
i 5 etiq Lleta .servieio.js 
index.js 

package-lockjson 

package.json 


Modificando los métodos de los controladores hacia los servicios de la siguiente manera: 
Controlador: 


1 module. exports = (router, servicios) => { 

router. getí 1 /artículo' r (req, res, next) => { 
return servicios . articulo. listar O 
.thení íarticules) => { 
return res . status (200) . j son (artículos); 

}) 

.catch (next); 

1 ); 

router. postí '/articulo' , íreq, res, next) => { 
return servicios . articulo. crear í req.body) 

.thení (articulo) => { 
return res . status (201) . j son (articulo); 

}) 

.catch (next); 

»; 

router. getí 1 /articulo/:id 1 , (req H res, next) => { 
return servicios .articulo. obtener ( req .params. id) 

.thení (articulo) => { 
return res . status (200) . json (articulo); 

}) 

.catch (next); 

router. put{ '/artículo/:id' , (req, res, next) => { 

return servicios . articulo. actualiza rí req.params . id, req.body) 
.thení (articulo) => { 
return res . status (200) . j soníarticulo) ; 

}) 

.catch (next); 

1 ); 

router. deleteí '/articulo/:id' , (req, res, next) => { 
return servicios . articulo. elimina r( req. params .id) 

.thení í) => { 

return res . status (200) .json ({}); 

}) 

.catch (next); 

»; 












Servicio: 

32 I // métodos Factory 

articuloServicio. crear = {params) => { 

return articuloServicio . guardar ( articuloServicio . construir (params)}; 

i; 

articuloServicio .actualizar = (id, params) => { 
ret u rn a rticuloSe rvicio . obtener (id) 

.then( (articulo) => { 

return articuloServicio. guardar (articulo, params); 

}); 

}■, 

articuloServicio .obtener = (id) => { 

return articuloServicio .encontrarüno{{ id }) 

.then( (articulo) => { 

if {¡articulo) throw new Error{ 1 Articulo no encontrado'); 

return articulo; 

}); 

50 } 

51 

articuloServicio .eliminar = (id) => { 
return articuloServicio .obtener (id) 

. then( articulóservicio.destruir) ; 

57 // métodos Aggregate 

articuloServicio. erearConEtiquetas = (params) => { 
return articuloServicio .crear (params.articulo) 

.thení (articulo) => { 

const etiquetaList = params.etiquetas. map( (etiqueta) => { 
return servicios.etiqueta. crear (params.etiqueta) ; 

}); 

return Promise. all (etiquetaList) .then[ () => { 
return articuloServicio .obtener (articulo.id) ; 

}) 

»; 

return articuloServicio; 

}; 





Utilizando los patrones del Diseño orientado al Dominio de la siguiente forma : 

• Repositorio, los métodos que recuperan u operan directamente con el almacenamiento 
de los datos: Base de Datos. 

• Fábrica, los métodos que construyen un objeto desde los parámetros enviados o desde 
el repositorio. 

• Agregado, los métodos que unen varias operaciones a través de una raíz, usando los 
métodos de fábrica y de repositorio. 

• Servicios, los métodos que componen una operación compleja entre dos o más 
dominios. 

El código de esta versión está en el tag vo.2-ddd 




Conclusiones 

Los controladores tienen responsabilidades limitadas convirtiéndose en una capa para 
recuperar los datos de la petición, enviarlos a los servicios y posteriormente enviar la respuesta 
al cliente. 

Los métodos de repositorio permiten limitar el acceso al almacenamiento (base de datos) 
haciendo que un cambio sobre los mismos no cambie el núcleo del sistema. 

Los métodos de fábrica (construcción y manipulación de objetos) permiten ser modificados 
fácilmente sin que se tenga que cambiar el acceso a la base de datos o la comunicación con el 
cliente. 

Al agregar la capa de servicio orientada al dominio, se tiene aislado el núcleo del sistema en 
métodos pequeños y escalables, de forma que ahí se enfoque el desarrollo principal del 
sistema. 
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Pytlian 3 

Estructura de Datos 


Hora de dejar de usar Python 2, y actualizar los conocimientos de la inmensa biblioteca 
estándar para Python 3. En las próximas entregas de esta columna introduciré un módulo de la 
biblioteca estándar de Python en casa número de esta revista. El texto es la traducción al 
español del sitio Python 3 Module of the Week de Doug Hellman, que ha sido publicado como el 
libro “The Python 3 Standard Library by Example”. 


Estructuras de datos 

Python incluye varias estructuras de datos de programación estándar, como list, tupie, dict, y 
set, como parte de sus tipos incorporados. Muchas aplicaciones no requieren otras estructuras, 
pero cuando lo hacen, la biblioteca estándar proporciona versiones poderosas y bien probadas 
que están listas para ser usadas. 

El módulo enum proporciona una implementación del tipo enumeración, con capacidades de 
iteración y comparación. Se puede usar para crear símbolos bien definidos para valores, en 
lugar de usar cadenas literales o enteros. 

El módulo collections incluye implementaciones de varias estructuras de datos que amplían las 
encontradas en otros módulos. Por ejemplo, Deque es una cola de doble extremo, que permite 
la adición o eliminación de elementos de ambos extremos. El defaultdict es un diccionario que 
responde con un valor predeterminado si falta una clave, mientras que OrderedDict recuerda la 
secuencia en la que se agregan los elementos a ésta, namedtuple extiende el tupie normal 
para dar a cada elemento un nombre de atributo además de un índice numérico. 

Para grandes cantidades de datos, un array puede hacer un uso más eficiente de memoria que 
una list. Como el array está limitado a un solo tipo de datos, puede usar una representación de 
memoria más compacta que una list de propósito general. Al mismo tiempo, las instancias de 
array se pueden manipular usando muchos de los mismos métodos que list, por lo que es 
posible reemplazar una list con un array en una aplicación sin muchos cambios. 

Ordenar elementos en una secuencia es un aspecto fundamental de la manipulación de datos. 
La list de Python incluye un método sort(), pero a veces es más eficiente mantener una lista 
ordenada sin volver a clasificarla cada vez que su contenido cambia. Las funciones en heapq 
modifican el contenido de una lista mientras preservan el orden de la lista con poca sobrecarga. 

Otra opción para crear listas ordenadas o arrays es bisect. Éste utiliza una búsqueda binaria 
para encontrar el punto de inserción para nuevos elementos, y es una alternativa a ordenar 
repetidamente una lista que cambia frecuentemente. 

Aunque la list incorporada puede simular una cola usando los métodos inserto y pop(), no es 
segura para subprocesos. Para una comunicación ordenada entre hilos de verdad usa el 
módulo queue. multiprocessing incluye una versión de Queue que funciona entre procesos, 
haciendo más fácil convertir un programa multi-hilo para que use procesos en su lugar. 

struct es útil para decodificar datos de otra aplicación, quizás viniendo de un archivo binario o 
una secuencia de datos, en tipos Python nativos para una manipulación más fácil. 








Este capítulo cubre dos módulos relacionados con la gestión de la memoria. Para estructuras 
de datos altamente interconectadas, como gráficos y árboles, usa weakref para mantener 
referencias mientras se permite que el recolector de basura limpie los objetos una vez que ya 
no son necesarios. Utiliza las funciones en copy para duplicar estructuras de datos y sus 
contenidos, incluida la realización de copias recursivas con deepcopy(). 

La depuración de las estructuras de datos puede llevar mucho tiempo, especialmente cuando 
recorriendo la salida impresa de grandes secuencias o diccionarios. Utiliza pprint para crear 
representaciones fáciles de leer que pueden ser impresas en la consola o escritas en un archivo 
de registro para una depuración más fácil. 

Finalmente, si los tipos disponibles no cumplen con los requisitos, subclasifica uno de los tipos 
nativos y personalízalo, o construye un nuevo tipo de contenedor utilizando una de las clases 
base abstractas definidas en collections como punto de partida. 


enum - Tipo de Enumeración 

El módulo enum define un tipo de enumeración con capacidades de iteración y comparación. 
Puede ser usado para crear símbolos bien definidos para valores, en lugar de usar enteros 
literales o cadenas. 

Creando enumeraciones 

Una nueva enumeración se define utilizando la sintaxis class creando una subclase de Enum y 
agregando atributos de clase que describen los valores. 

# enum create.py 



import enum 

class BugStatus(enum.Enum): 
new = 7 

incomplete = 6 
invalid = 5 
wont_fix = 4 
in_progress = 3 
fix_committed = 2 
fix_released = 1 

print( '\nMember ñame: {}'.format(BugStatus.wont_fix.ñame)) 
print('Member valué: {}'.format(BugStatus.wont_fix.valué)) 


Los miembros del Enum se convierten en instancias cuando la clase es analizada. Cada 
instancia tiene una propiedad ñame que corresponde al nombre del miembro y una propiedad 
valué correspondiente al valor asignado al nombre en la definición de la clase. 

$ python3 enum create.py 


Member ríame: wont_fix 
Member valué: 4 


Iteración 

Iterar sobre la clase emun produce los miembros individuales de la enumeración. 
# enum iterate.py 














import enum 

class BugStatus(enum.Enum): 
new = 7 

incomplete = 6 
invalid = 5 
wont_fix = 4 
in_progress = 3 
fix_committed = 2 
fix_released = 1 
for status in BugStatus: 

print('{:15} = {}'.format(status.ñame, status.valué)) 


Los miembros se producen en el orden en que se declaran en la definición de la clase. Los 
nombres y valores no se usan para ordenarlos de ninguna manera. 

$ python3 enum iterate.py 


new 

= 7 

incomplete 

= 6 

invalid 

= 5 

wont_fix 

= 4 

in_progress 

= 3 

fix_committed 

= 2 

fix_released 

= 1 


Comparando Enums 

Como los miembros de la enumeración no están ordenados, solo admiten comparación por 
identidad e igualdad. 

# enum comparison.py 



import enum 

class BugStatus(enum.Enum): 
new = 7 

incomplete = 6 
invalid = 5 
wont_fix = 4 
in_progress = 3 
fix_committed = 2 
fix_released = 1 

actual_state = BugStatus.wont_fix 
desired_state = BugStatus.fix_released 
print('Equality:', 

actual_state == desired_state, 
actual_state == BugStatus.wont_fix) 
print('Identity :', 

actual_state is desired_state, 
actual_state is BugStatus.wont_fix) 
print('Ordered by valué:') 
try: 

print('\n'.join(' ' + s.name for s in sorted(BugStatus))) 

except TypeError as err: 

print(' Cannot sort: {}'.format(err)) 


Los operadores de comparación mayor que y menor que elevan excepciones TypeError. 

$ python3 enum comparison.py 















Equality: False True 
Identity: False True 
Ordered by valué: 

Cannot sort: '<' not supported between instances of 'BugStatus' and 'BugStatus' 


Usa la clase IntEnum para enumeraciones donde los miembros necesitan comportarse más 
como números - por ejemplo, para ofrecer comparaciones. 

# enum intenum.py 



import enum 

class BugStatus(enum.IntEnum): 
new = 7 

incomplete = 6 
invalid = 5 
wont_fix = 4 
in_progress = 3 
fix_committed = 2 
fix_released = 1 
print('Ordered by valué:') 

print('\n'.join(' ' + s.name for s in sorted(BugStatus))) 


$ python3 enum intenum.py 


Ordered by valué: 
fix_released 
fix_committed 
in_progress 
wont_fix 
invalid 
incomplete 
new 


i 


Valores de enumeración únicos 

Los miembros de Enum con el mismo valor se tratan como referencias de alias al mismo objeto 
miembro. Los alias no hacen que los valores repetidos estén presentes en el iterador para el 
Enum. 

# enum aliases.py 


import enum 

class BugStatus(enum.Enum): 
new = 7 

incomplete = 6 
invalid = 5 
wont_fix = 4 
in_progress = 3 
fix_committed = 2 
fix_released = 1 
by_design = 4 
closed = 1 

for status in BugStatus: 

print('{:15} = {}'.format(status.ñame, status.valué)) 
print( '\nSame: by_design is wont_fix: 

BugStatus.by_design is BugStatus.wont_fix) 
print('Same: closed is fix_released: ', 

BugStatus.closed is BugStatus.fix_released) 


Porque by_design y closed son alias para otros miembros, no aparecen por separado en el 

















resultado al iterar sobre el Enum. El nombre canónico para un miembro es el primer nombre 
unido al valor. 

$ python3 enum aliases.py 


new 

= 7 


incomplete 

= 6 


invalid 

= 5 


wont_fix 

= 4 


in_progress 

= 3 


fix_committed 

= 2 


fix_released 

= 1 


Same: by_design 

is wont_fix: 

True 

Same: closed is 

fix_released: 

True 


Para requerir que todos los miembros tengan valores únicos, agregue el decorador @unique al 
Enum. 

# enum unique enforce.py 


import enum 
@enum.unique 

class BugStatus(enum.Enum): 
new = 7 

incomplete = 6 
invalid = 5 
wont_fix = 4 
in_progress = 3 
fix_committed = 2 
fix_released = 1 

# This will trigger an error with unique applied. 
by_design = 4 
closed = 1 



Los miembros con valores repetidos elevan una excepción ValueError cuando la clase Enum 
está siendo interpretada. 

$ python3 enum unique enforce.py 


Traceback (most recent cali last): 

File "enum_unique_enforce.py", line 11, in <module> 
class BugStatus(enum.Enum): 

File ".../lib/python3.6/enum.py", line 834, in unique 
(enumeration, alias_details)) 

ValueError: duplicate valúes found in <enum 'BugStatus'>: 
by_design -> wont_fix, closed -> fix_released 


Creando enumeraciones programáticamente 

En algunos casos, es más conveniente crear enumeraciones programáticamente, en lugar de 
codificarlos en una definición de clase. Para esas situaciones, Enum también admite pasar los 
nombres y valores de los miembros al constructor de la clase. 

# enum programmatic create.py 

















import enum 
BugStatus = enum.Enum( 
value='BugStatus', 

names=('fix_released fix_committed in_progress ' 
'wont_fix invalid incomplete new'), 

) 

print('Member: {}'.format(BugStatus.new)) 
print('\nAll members:') 
for status in BugStatus: 

print('{:15} = {}'.format(status.ñame, status.valué)) 



El argumento valué es el nombre de la enumeración, que se usa para compilar la 
representación de los miembros. El argumento ñames lista los miembros de la enumeración. 
Cuando se pasa una sola cadena, es dividida en espacios en blanco y comas, y los tokens 
resultantes se utilizan como nombres para los miembros, que son valores asignados 
automáticamente comenzando con 1. 

$ python3 enum programmatic create.py 


Member: BugStatus.new 


All members: 
fix_released = 1 

fix_committed = 2 

in_progress = 3 

wont_fix = 4 

invalid = 5 

incomplete = 6 

new = 7 




Para un mayor control sobre los valores asociados con los miembros, la cadena ñames se 
puede reemplazar por una secuencia de tupias de dos partes o un diccionario mapeando 
nombres a valores. 

# enum programmatic mapping.py 


import enum 
BugStatus = enum.Enum( 
value='BugStatus', 
names=[ 

('new', 7), 

('incomplete', 6), 

('invalid', 5), 

('wont_fix', 4), 

('in_progress', 3), 

('fix_committed', 2), 

('fix_released', 1), 

], 

) 

print('All members:') 
for status in BugStatus: 

print('{:15} = {}'.format(status.ñame, status.valué)) 


En este ejemplo, se proporciona una lista de tupias de dos partes en lugar de una sola cadena 
que contiene solo los nombres de los miembros. Esto hace posible reconstruir la enumeración 
BugStatus con los miembros en el mismo orden como la versión definida en enum_create.py. 

$ python3 enum programmatic mapping.py 













All members: 
new = 7 

incomplete = 6 

invalid = 5 

wont_fix = 4 

in_progress = 3 

fix_committed = 2 

fix_released = 1 


Valores miembros no enteros 

Los valores de miembro de Enum no están restringidos a enteros. De hecho, cualquier tipo de 
objeto se puede asociar con un miembro. Si el valor es una tupia, los miembros se pasan como 
argumentos individuales a_init_(). 

# enum tuple values.py 


import enum 


class BugStatus(enum.Enum): 


new = (7, ['incomplete', 

'invalid', 

'wont_fix', 

'in_progress']) 

incomplete = (6, ['new', 'wont_fix']) 
invalid = (5, ['new']) 
wont_fix = (4, ['new']) 

in_progress = (3, ['new', 'fix_committed']) 
fix_committed = (2, ['in_progress', 'fix_released 
fix_released = (1, ['new']) 

']) 

def _init_(self, num, transitions): 

self.num = num 

self.transitions = transitions 


def can_transition(self, new_state): 

return new_state.ñame in self.transitions 


print('Ñame:', BugStatus.in_progress) 

print('Valué:', BugStatus.in_progress.valué) 

print('Custom attribute:', BugStatus.in_progress.transitions) 

print('Using attribute:', 

BugStatus.in_progress.can_transition(BugStatus.new)) 



En este ejemplo, cada valor de miembro es una tupia que contiene el ID numérico (tal como 
podría estar almacenado en una base de datos) y una lista de transiciones a partir del estado 
actual. 

$ python3 enum tuple values.py 


Ñame: BugStatus.in_progress 
Valué: (3, ['new', 'fix_committed']) 

Custom attribute: ['new', 'fix_committed'] 
Using attribute: True 


Para casos más complejos, las tupias pueden volverse difíciles de manejar. Como cualquier tipo 
de objeto puede ser valor miembro, los diccionarios se pueden usar para los casos donde hay 
muchos atributos separados para seguir por cada valor enum. Los valores complejos se pasan 
directamente a_init_() como único argumento que no sea self. 













# enum complex values.py 


import enum 

class BugStatus(enum.Enum): 
new = { 

'num': 7, 

'transitions': [ 

'incomplete', 

'invalid', 

'wont_fix', 

'in_progress', 

], 

> 

incomplete = { 

'num': 6, 

'transitions': ['new', 'wont_fix'], 

} 

invalid = { 

'num': 5, 

'transitions': ['new'], 

} 

wont_fix = { 

'num': 4, 

'transitions': ['new'], 

} 

in_progress = { 

'num': 3, 

'transitions': ['new', 'fix_committed'], 

} 

fix_committed = { 

'num': 2, 

'transitions': ['in_progress', 'fix_released'], 

} 

fix_released = { 

'num': 1, 

'transitions': ['new'], 

} 

def _init_(self, vals): 

self.num = vals['num'] 
self.transitions = vals['transitions'] 

def can_transition(self, new_state): 

return new_state.ñame in self.transitions 


print('Ñame:', BugStatus.in_progress) 

print('Valué:', BugStatus.in_progress.valué) 

print('Custom attribute:', BugStatus.in_progress.transitions) 

print('Using attribute:', 

BugStatus.in_progress.can_transition(BugStatus.new)) 



Este ejemplo expresa los mismos datos que el ejemplo anterior, utilizando diccionarios en lugar 
de tupias. 

$ python3 enum complex values.py 


Ñame: BugStatus.in_progress 

Valué: {'num': 3, 'transitions': ['new', 'fix_committed']} 
Custom attribute: ['new', 'fix_committed'] 

Using attribute: True 
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